package city.spring.modules.reception.service;

import city.spring.modules.reception.entity.OldmanServiceRecordEntity;
import city.spring.modules.reception.vo.OldmanServiceRecordVO;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import lombok.NonNull;
import org.apache.ibatis.annotations.Param;

import java.security.Principal;
import java.util.List;

/**
 * Service：志愿者服务记录
 *
 * @author pxm
 * @date 2020-07-01 11:16:48
 */
public interface OldmanServiceRecordService extends IService<OldmanServiceRecordEntity> {
    String CACHE_NAME = "oldman_service_record";

    /**
     * 业务处理：保存一个 <strong>志愿者服务记录</strong>
     *
     * @param entity 志愿者服务记录
     */
    void saveOldmanServiceRecord(OldmanServiceRecordEntity entity, @NonNull Principal user);

    /**
     * 业务处理：修改一个 <strong>志愿者服务记录</strong>
     *
     * @param entity 志愿者服务记录
     */
    void updateOldmanServiceRecord(OldmanServiceRecordEntity entity);

    /**
     * 业务处理：修改一个 <strong>志愿者服务记录</strong>
     *
     * @param entity 志愿者服务记录
     */
    void updateOldmanServiceRecordByVolunteer(OldmanServiceRecordEntity entity);

    /**
     * 业务处理：删除一个 <strong>志愿者服务记录</strong>
     *
     * @param primaryKey 主键ID
     */
    void deleteOldmanServiceRecord(String primaryKey);

    /**
     * 业务处理：删除多个 <strong>志愿者服务记录</strong>
     *
     * @param primaryKeys 主键ID列表
     */
    void deleteOldmanServiceRecord(List<String> primaryKeys);

    /**
     * 分页获取的服务记录
     *
     * @param page    分页对象
     * @param wrapper 查询对象
     * @return 服务记录
     */
    IPage<OldmanServiceRecordVO> listPage(Page<? extends OldmanServiceRecordEntity> page, @Param(Constants.WRAPPER) Wrapper<? extends OldmanServiceRecordEntity> wrapper);
}